home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glpollasyncsgix.z / glpollasyncsgix
Encoding:
Text File  |  2002-10-03  |  7.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX((((3333GGGG))))            OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee            ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX - poll for completion of an asynchronous command
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      GLint ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX( GLuint *_m_a_r_k_e_r_p )
  14.  
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _m_a_r_k_e_r_p  Returns a marker for a completed asynchronous command.
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX is part of the SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc extension.  This extension
  21.      provides a framework within which particular sets of OpenGL commands can
  22.      become "asynchronous" via specific further OpenGL extensions.  Currently
  23.      the SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc____ppppiiiixxxxeeeellll extension is the only such defined extension.
  24.  
  25.      Asynchronous commands are commands that may complete out-of-order with
  26.      respect to other OpenGL commands.  An asynchronous command samples the
  27.      OpenGL state vector when it is issued.  The sampled state includes the
  28.      results from the complete execution of all synchronous (normal) commands
  29.      issued prior to the asynchronous command.  However, the results of an
  30.      asynchronous command (state changes or framebuffer updates) are not
  31.      necessarily committed in order.  An asynchronous command may commit its
  32.      results any time after the completion of all synchronous commands issued
  33.      prior to the asynchronous command.  An implementation may choose to
  34.      execute asynchronous commands in parallel with subsequent commands or at
  35.      some convenient time in the future.
  36.  
  37.      Implementations of asynchronous commands may also be non-blocking.  For
  38.      example, a non-blocking query command returns control to the program
  39.      immediately rather than stalling the program until the results of the
  40.      query are available.
  41.  
  42.      Note that this language allows any particular asynchronous command to
  43.      behave exactly as if it were not asynchronous, if the implementation
  44.      chooses.
  45.  
  46.      ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX returns 1 when an asynchronous command has completed; in
  47.      this case it writes the marker associated with the completed command into
  48.      the integer referred to by _m_a_r_k_e_r_p.  If there are no pending asynchronous
  49.      commands, or if there are pending asynchronous commands but none have
  50.      completed, ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX returns 0 immediately and does not modify the
  51.      integer referred to by _m_a_r_k_e_r_p.
  52.  
  53.      Once OpenGL has reported the completion of an asynchronous command via
  54.      either ggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX, the completion status of the
  55.      command will not be reported again.  If several commands have the same
  56.      marker associated with them, the completion status of each command will
  57.      be reported separately, although these reports will be indistinguishable.
  58.      The order in which asynchronous commands are reported is undefined.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX((((3333GGGG))))            OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee            ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      A program may guarantee that all outstanding asynchronous commands have
  75.      completed by calling ggggllllFFFFiiiinnnniiiisssshhhh.  A call to ggggllllFFFFiiiinnnniiiisssshhhh does not cause the
  76.      completion status of outstanding commands to be reported, so subsequent
  77.      calls to ggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX will report the status of
  78.      such commands.
  79.  
  80. EEEERRRRRRRROOOORRRRSSSS
  81.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX is executed between
  82.      the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  83.  
  84.  
  85. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  86.      The SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc and SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc____ppppiiiixxxxeeeellll extensions are implemented only on
  87.      OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo systems.
  88.  
  89.  
  90. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  91.      ggggllllAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrSSSSGGGGIIIIXXXX, ggggllllDDDDeeeelllleeeetttteeeeAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrssssSSSSGGGGIIIIXXXX, ggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX,
  92.      ggggllllGGGGeeeennnnAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrssssSSSSGGGGIIIIXXXX, ggggllllIIIIssssAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrSSSSGGGGIIIIXXXX, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss,
  93.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.